home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 21 / Cream of the Crop 21 (Terry Blount) (October 1996).iso / os2 / lynxos26.zip / help / lynx_use.ori < prev   
Text File  |  1995-03-23  |  39KB  |  906 lines
  1. <html><head><title>Lynx Users Guide v2.3-FM</title>
  2. <!--OWNER_NAME="ACS"-->
  3. <!--OWNER_INFO="Academic Computing Services, University of Kansas"-->
  4. <link rev="made" href="mailto:lynx-help@ukanaix.cc.ukans.edu">
  5. </head><body>
  6.  
  7. <h1>Lynx Users Guide Version 2.3-FM</h1>
  8.  
  9. Lynx is a fully-featured World Wide Web (WWW) client for users
  10. running cursor-addressable, character-cell display devices (e.g.,
  11. vt100 terminals, vt100 emulators running on PCs or Macs, or any
  12. other "curses-oriented" display).  It will display hypertext
  13. markup language (HTML) documents containing links to
  14. files residing on the local system, as well as files residing on
  15. remote systems running Gopher, HTTP, FTP, WAIS, and NNTP servers. 
  16. Current versions of Lynx run on UNIX and VMS.  A Beta version for DOS 
  17. is also available.<p>
  18. Lynx can be used to access information on the World Wide Web, or
  19. to build information systems intended primarily for local access. 
  20. For example, Lynx has been used to build several Campus Wide
  21. Information Systems (CWIS).  In addition, Lynx can be used to
  22. build systems isolated within a single LAN. <P>
  23.  
  24. <A NAME="TOC"><h2>Select a topic</h2></A>
  25. <ul>
  26. <li><A HREF="#1">Viewing local files with Lynx</A>
  27. <li><A HREF="#2">Lynx online help</A>
  28. <li><A HREF="#3">Leaving Lynx</A>
  29. <li><A HREF="#4">Starting Lynx with a Remote File</A>
  30. <li><A HREF="#5">Starting Lynx with the the WWW_HOME environment variable.</A>
  31. <li><A HREF="#6">Navigating hypertext documents with Lynx</A>
  32. <li><A HREF="#7">Printing, Mailing, and Saving files to disk.</A>
  33. <li><A HREF="#8">Lynx searching commands</A>
  34. <li><A HREF="#9">Lynx options menu</A>
  35. <li><A HREF="#10">Comments and mailto: links</A>
  36. <li><A HREF="#18">USENET News posting</A>
  37. <li><a href="#19">Lynx and HTML Forms</a>
  38. <li><A HREF="#11">Viewing the HTML document source and editing documents</A>
  39. <li><A HREF="#12">Reloading files and refreshing the display</A>
  40. <li><A HREF="#13">Lynx bookmarks</A>
  41. <li><A HREF="#13A">Jump command</A>
  42. <li><A HREF="#13B">Directory Editing</A>
  43. <li><A HREF="#14">Other useful commands</A>
  44. <li><A HREF="#15">The Lynx command</A>
  45. <li><A HREF="#16">Lynx development history</A>
  46. <li><A HREF="#17">Additional Information</A>
  47. </ul>
  48.  
  49. <h2><A NAME="1">Viewing local files with Lynx</A></h2>
  50. Lynx can be started by entering the Lynx command along with
  51. the name of a file to display.  For example these commands could
  52. all be used to display an arbitrary ASCII text file. 
  53.  
  54. <dl>
  55.  <dt>UNIX
  56.   <dd><code>lynx myfile</code>
  57.   <dd><code>lynx /home/my-dir/myfile</code>
  58.  <dt>VMS
  59.   <dd><code>lynx dua5:[my-directory]myfile</code>
  60. </dl>
  61.  
  62. When executed, Lynx will clear the screen and display as much of
  63. the specified file as will fit on the screen.  Pressing a
  64. down-arrow will bring up the next screen, and pressing an up-arrow
  65. will bring up the previous screen. If no file is specified at startup,
  66.  a default file will be displayed.  (The default is configured by the 
  67. system administrator when the command is installed.)<p>
  68.  
  69. Lynx will also display files written in the HyperText
  70. Markup Language (HTML), if the file's name ends with the
  71. characters ".html".  HTML is a file format that allows users to
  72. create a file that contains (among other things) hypertext links
  73. to other files.  Several files linked together may be described as
  74. a <i>hypertext document</i>.<p>
  75. For example, these commands could be used to display files
  76. containing HTML hypertext:
  77.  
  78. <dl>
  79.   <dt>UNIX
  80.      <dd><code>lynx myfile.html</code>
  81.      <dd><code>lynx /home/my-dir/myfile.html</code>
  82.   <dt>VMS
  83.      <dd><code>lynx dua5:[me]myfile.html</code>
  84. </dl>
  85.  
  86. When Lynx displays an HTML file, it shows links as "bold face"
  87. text, except for one link, which is shown as "highlighted" text. 
  88. Whether "boldface" or "highlighted" text shows up as reverse
  89. video, boldface type, or a color change, etc. depends on the
  90. display device being used (and the way in which that device has
  91. been configured).  Lynx has no control over the exact presentation
  92. of links.<p>
  93. The one link displayed as "highlighted" text is the currently
  94. "selected" link.  Lynx will display the file associated with the
  95. selected link when a right-arrow or a Return key is pressed.  To
  96. select a particular link, press the up-arrow or down-arrow keys
  97. until the desired link becomes "highlighted," and then press the
  98. right-arrow or Return key to view the linked information. 
  99. Information included in the HTML file tells Lynx where to find the
  100. linked file and what kind of server will provide it (i.e.  HTTP,
  101. Gopher, etc.). <p>
  102.  
  103. When a binary file is encountered Lynx will ask the user if
  104. he/she wishes to download the file or cancel. If the user
  105. selects 'D' for download, Lynx will transfer the file into a
  106. temporary location and present the user with a list of options. The
  107. only default option is "save file to disk", which is disabled
  108. if Lynx is running in anonymous mode. Any number of additional 
  109. download methods may be defined in the lynx.cfg file by the system 
  110. administrator. Programs like kermit, zmodem and FTP are some possible
  111. options. <A HREF="#TOC">ToC</A>
  112.  
  113. <h2><A NAME="2">Lynx online help</A></h2>
  114. Online help is available while viewing any document.  Press the
  115. '?' or 'H' key to see a list of help topics.  See the section
  116. titled <A HREF="#6">'Navigating hypertext documents with Lynx'</A> for 
  117. information on navigating through the help files. <A HREF="#TOC">ToC</A>
  118.  
  119. <h2><A NAME="3">Leaving Lynx</A></h2>
  120. To exit Lynx use the 'q' command.  You will be asked whether you
  121. really want to quit.  Answering 'y' will exit and 'n' will return
  122. you to the current document. Use 'Q' or CTRL-D to quit without verification.
  123. <A HREF="#TOC">ToC</A>
  124.  
  125. <h2><A NAME="4">Starting Lynx with a Remote File</A></h2>
  126. If you wish to view a remote file (that is, a file residing on
  127. some computer system other than the one upon which you are running
  128. Lynx) without first viewing a local file, you must identify that
  129. file by using a Uniform Resource Locator (URL).  URL's take the
  130. general form:
  131. <br><br>
  132.  <code>PROTOCOL :// HOST / PATH / FILENAME</code>
  133. <br><br>
  134.  
  135. where
  136.  
  137. <dl>
  138.    <dt><code>PROTOCOL</code>
  139.     <dd>identifies the communications
  140.      protocol used by the server that will provide the file.  As
  141.      mentioned earlier, Lynx (and any WWW client) can interact with a
  142.      variety of servers, each with its own protocol. 
  143.    <dt><code>HOST</code>
  144.     <dd>is the Internet address of the computer
  145.      system on which the server is running, and
  146.    <dt><code>PATH</code> and <code>FILENAME</code>
  147.     <dd>identify the directory path and file of interest. 
  148. </dl>
  149.  
  150. Here are some sample URL's.
  151. <dl>
  152.    <dt>HTTP  (HyperText Transfer Protocol)
  153.          <dd><code>http://www.cc.ukans.edu/lynx_help/lynx_help_main.html</code>
  154.    <dt>Gopher
  155.          <dd><code>gopher://gopher.micro.umn.edu/11/</code>
  156.    <dt>FTP  (File Transfer Protocol)
  157.          <dd><code>ftp://ftp2.cc.ukans.edu/pub/lynx/README</code>
  158.    <dt>WAIS  (Wide Area Information Service protocol)
  159.          <dd><code>wais://cnidr.org/directory-of-servers</code>
  160. </dl>
  161.  
  162.   A URL may be specified to Lynx on the command line, as in:
  163. <dl>
  164.    <dd><code>lynx http://kufacts.cc.ukans.edu/cwis/kufacts_start.html</code>
  165. </dl> 
  166. <A HREF="#TOC">ToC</A>
  167.  
  168. <h2><A NAME="5">Starting Lynx with the the WWW_HOME environment variable.</A></h2>
  169. You may also specify a starting file for Lynx using the WWW_HOME
  170. environment variable,
  171. <dl>
  172.    <dt>UNIX
  173.       <dl>
  174.          <dt>ksh
  175.               <dd><code>export WWW_HOME=http://info.cern.ch/default.html</code>
  176.          <dt>csh
  177.            <dd><code>setenv WWW_HOME http://info.cern.ch/default.html</code>
  178.      </dl>
  179.    <dt>VMS
  180.       <dd><code>define "WWW_HOME" "http://info.cern.ch/default.html"</code>
  181. </dl>  
  182.  
  183.  
  184. <h2><A NAME="6">Navigating hypertext documents with Lynx</A></h2>
  185.  
  186. The process of moving within a hypertext web, selecting and displaying
  187. links is known as "navigation." With Lynx almost all navigation can be
  188. accomplished with the arrow keys and the numeric keypad. 
  189. <pre>
  190.                                        +-------+-------+-------+
  191.                                        | TOP   |  /|\  | Page  |
  192.               arrow keys               | of    |   |   | UP    |
  193.                                        | text 7|   |  8|      9|
  194.               +---------+